home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga Collections: Taifun
/
Taifun 257 (1993-09-10)(Manewaldt, A.)(DE)(PD).zip
/
Taifun 257 (1993-09-10)(Manewaldt, A.)(DE)(PD).adf
/
SIP
/
SIP_ENG.doc
< prev
next >
Wrap
Text File
|
1993-09-07
|
13KB
|
393 lines
SIP V2.12
- FREEWARE -
(c) 1992-93 by Andreas R. Kleinert. All rights reserved.
This program was written under OS V3.00 and is therefore
fully compatible. It needs OS >= V2.04.
This program needs 'asl.library' V37+ (in "LIBS:")
and 'diskfont.library' V37+ (in "LIBS:").
Release Date : 10.06.1993
Copyright :
===========
The program SIP V2.12 and its documentation files are
(C)opyright 1992-93 by Andreas R. Kleinert. All rights reserved.
Disclaimer :
============
The author takes no responsibility for any results of the use of this
program.
This software is provided "AS IS" and there is no warranty of any kind,
so that you use this software at your own risk.
Distribution :
==============
The program SIP V2.12 is freely distributable (FREEWARE).
You may copy it, if the copyright notice is left intact and
all of its parts are included in the distribution.
This program must not be included in commercial packages or commercial
program collections without my written permission.
This program must not be sold in any way, but it is allowed to take
a nominal fee including the costs for copying.
This program may be put on public domain disks or included in public
domain disk libraries.
Special permission hereby goes to Fred Fish's AmigaLib-Disks and
the german series TAIFUN, FRANZ, TIME, GPD and Amiga Szene.
This program may also be distributed via electronic mail and may be
put into mailboxes as long as the redistribution conditions are
respected in all points.
By using or distributing this program you automatically agree to
all of the above conditions and terms.
Intention :
===========
"SIP" stands for "System Information Program".
SIP may look very similar to other programs with similar intentions,
but has really nothing to do with them except of the task to fulfil.
What I wanted to create, was a program that should bring the same comfort
to you as other programs, but which also should be compatible to the new
OS 2.04 and use the special features of the new Kickstart.
Function :
==========
SIP allows you to watch and manipulate most of the elementary parts of
the Operating System of your Amiga, as (e.g.) Tasks, Libraries, Devices,
Ports and Windows.
It also brings you the possibility of viewing some of the most important
vectors in the system and to clear them, to make sure to keep your system
free of viruses and all the other garbage which affects working with
your Amiga.
SIP is written under V3.00 of the AmigaOS and only runs under OS V2.04+.
Which means that the lowest accepted library version is V37 !
Usage :
=======
Function-Overview :
-------------------
Gadget Function
----------------------------------------------------------------------
Tasks Show Tasks by name and more
Windows Show Windows by name
Libraries Show Libraries by name and more
Devices Show Devices by name and more
Resources Show Resources by name and more
Ports Show Ports by name and more
Residents Show Residents by name and more
Interrupts Show Interrupts by number and more
Vectors Show some vectors (CoolCapture, etc.)
Memory Show information about memory
Mount Show all mounted devices by name
Assign Pop up a File-Requester to show assigns and volumes
Fonts Pop up a Font-Requester to show all available fonts
Hardware Give some information about the Hardware
Action-Gadget Function
----------------------------------------------------------------------
Remove! Remove a Task/Window/Library/Device/Resource/Port or
Interrupt
(ONLY when in this Mode).
Priority! Set new Priority for a Task/Library/Device/Resource/
Port or Resident
(ONLY when in this Mode).
Reserved! (Not selectable, reserved.)
Clear! Clear Cold-/Cool- and WarmCapture entries in SysBase
(ONLY when in this Mode).
<Close-Gadget> (see MENUS : "Quit")
Menu Function
----------------------------------------------------------------------
Info About SIP and me
Help About SIP's gadgets
Quit You may choose between three possibilities :
- Cancel 1. Go back.
2. Iconify
- O.K. /
\
3. Really Quit
1st Note : "Iconify" saves about 50000 Bytes of memory (Screen, ...).
2nd Note : You may click on all the gadgets without destroying anything,
EXCEPT the following gadgets :
- Remove! Remove s.th., if s.th. is chosen
- Clear! Clear vectors, if clicked VECTORS before
- Priority! Set priority, if s.th. is chosen
- Reserved! (Not selectable, reserved.)
Here's an example, how to "Remove!" a Task from the system :
Example :
---------
Action Gadget / Text to select
--------------------------------------
<Clicked on> Tasks
<Selected> "Background CLI"
<Clicked on> Remove
Then you'll see, that the task "Background CLI" will have been
removed.
Menu Function
----------------------------------------------------------------------
Project/Help Opens the Help-Window of SIP
/Info Opens the Info-Window of SIP
/Start WB Starts the Workbench
Switch/SIP Dos Tools Switches to the "SIP Dos Tools"
SIP Dos Tools :
---------------
In the Menu "SIP Dos Tools" you may view Bootblocks of Disks
(DF1: to DF3:) or format Disks or Dos-Volumes (DF1: bis DF3,
any Devices).
Please note, that for formatting of 720 KB-Disks the appropriate
Handlers (PC0: bis PCx:) have to be mounted and that Quick-Formatting
of Amiga- to 720 KB-Disks or of 720 KB- to Amiga-Disks cannot work.
Therefore for this, as well as for new Disks, please select
Hard-Formatting.
Also the maximum length for the name of 720 KB-Disks is 12 characters :
the rest will be ignored.
For Hard-Formatting "SYS:System/Format" is used.
Notes :
=======
On slower (7.1x MHz) Amigas it is possible, that showing some "types" of
information may need some time - especially viewing the Residents -
Don't panic if your Amiga doesn't react for two or three seconds
(the mouse pointer doesn't move).
This is not a DeadLock, this is just because of some Forbid()/Permit()
calls and because of the mass of data to be shown in the gadtools-Gadgets.
Another reason is, that the -Gadgets also need a specific amount
of CPU-time (IDCMP_INTUITICKS).
So wait a moment, before you just "CTRL-Amiga-Amiga" ! O.K. ?
Well : While viewing e.g. the Residents, all Tasks and Interrupts are
desactivated for a time, which means that, e.g. a running background
music may sound somewhat strange for a moment.
Construction :
==============
- SIP uses a PAL-Screen (640x256) ! Sorry, NTSC-Users !
- The surface of this program has been created under use of the famous
program "GadToolsBox V1.4", written by Jan van den Baard.
- SIP makes use of the 'asl.library' V37+ and the 'diskfont.library' V37+
of the Workbench V2.04+.
- Many of the functions of this program are to find as more powerful and
more complexe CLI-Commands in my CLI-/Shell-Package "AKCC", which is
SHAREWARE and to find on several Public Domain Series.
The current version/release number of AKCC is V2.2.0 (at the moment
with 35 commands).
Correspondence :
================
If you like, you may send me some money. Perhaps this will motivate me
to continue programming such programs or just making updates of
this one. Send bug-reports, suggestions, money (!) or whatever to :
Andreas R. Kleinert,
Grube Hohe Grethe 23,
D-57074 Siegen
Germany.
History :
=========
V2.12 : (10.06.1993, original size : 35692 Bytes)
-------
- now with additional menupoint "SIP Dos Tools"
(integration of "KBoot V1.02" and "Well-Format V1.00") :
- Viewing of Bootblocks of Disks
- Diskformatting quick/hard, OFS/FFS ic
(quick : internal, hard : external ("SYS:System/Format") )
- improved error-handling in low-memory situations
- removed unnecessary code
- changed Task-Display
- changes in Residents-/Libraries-/Devices-/Handler-Viewer
- another bug-fix in the Resident-Viewer
- bug-fix in the Resource-Viewer
V2.06 : (12.05.1993, original size : 29708 Bytes)
-------
- Hardware : added Agnus/Alice recognition. Not perfect so far !?
- the "Resident-View-WB-Known-Bug" now seems to be FINALLY fixed
- internal changes to the Interrupt-Routine
- some optimizations
V2.05 : (15.04.1993, original size : 29964 Bytes)
-------
- Remove! : new Requester for Tasks/Processes :
1. RemTask
2. Break Task (CTRL-C, -D, -E or -F)
- Hardware : recognizes Denise-/Lisa-Chips via their ID
- new Menu for starting Workbench
V2.04 : (April 1993, original size : 28088 Bytes)
-------
- Resident-Viewer still crashed sometimes. Bug hopefully fixed now.
- new abort-routine (V33-style Error-Requester, runs anywhere).
- found out, that Asl-Font-Requester at least needs "diskfont.library"
of OS V2.0x to pop up. Added note to Doc-File.
V2.03 : (original size : 27856 Bytes)
-------
- improvements
- more informationen about Handler ("MOUNT" before)
V2.02 : (original size : 27668 Bytes)
-------
- use of SAS/C V6.00
- fixed a bad bug, which occured under OS V3.0
(Kickstart V39.106, exec.library V39.47, intuition.library V39.2084,
gadtools.library V39.356), but _not_ under OS V2.04 !!!
If selected the ListView-Gadget, a "class&IDCMP_CLOSEWINDOW"
resulted in TRUE, although it should not.
This should have been filtered out by "GT_GetIMsg()", but was not.
Now using an absolutely clear "class==IDCMP_CLOSEWINDOW".
- added auto-activation
- re-added possibility to watch files in Assign-Requester
- fixed handling of Resident-IDs (might have been crashed, if no
valid ID-Pointer (or NULL) set), Forbid()/Permit()
- removed memory-values from "Hardware" and fixed those values in
"Memory" (so that "not FAST ..." is reported, if 0x00000000 is
found)
- changed/added some other things
- improved doc-file (even older revision-entries)
V2.01 : (original size : 27672 Bytes)
-------
- added some "__aligned" statements
- fixed another (possible) bug-source in string-buffering
- closed silly "memory black-hole" in "Mount"-Option
V2.00 :
-------
- changed name from "BRTM" to "SIP", to show that it is not just
a clone of other programs with its intention
- complete re-design of the Surface, because of use of
GadToolsBox V1.4 : code should be better now (less
"by hand"-changes because of multiple-windows technique).
- changes in Help- and Info-Window, as well as small
differences in quality of design.
- fixed a bug in string-buffering and conversion of strings
for Screen-Display
(perhaps this wasn't the last one ...)
- AGAIN : improvements on this doc-file
(yes, you are still reading it ...)
V1.05 :
-------
- fixed some "surface" things ("More" now is fully obsolete),
changed some texts inside
- fixed a bad bug in clear-routine for gadgets
- consequent use of "__regargs" (SAS/C V5.10a/b)
- improves on this doc-file
(yes, this which you are reading now ...)
- Asl-Requester (for Assigns) now for Dirs only
(no selection of files possible any longer)
- Requesters are (should be) bigger
V1.01 :
-------
- self-detaches from CLI/Shell by "cback.o"
- improved display of library-data
- more information about resources
- number of messages displayed, when "hanging" at ports
- "$VER"sion-string for use with the CLI-/Shell-Command "Version"
- closes the remaining stdio-window on the WB
(=> no longer error-texts on the WB, but in the CLI/Shell).
V1.00 :
-------
- First and initial release.
Specific Copyrights :
=====================
- "GadToolsBox" (V1.0/V1.4) is FREEWARE and
(c) 1991,92 by Jan van den Baard.
- "AKCC" V2.2.0 is SHAREWARE and
(c) 1990-93 by Andreas R. Kleinert.
Copyrights :
============
Some of the mentioned names or products above may be copyrighted by
companies or trademarks of companies.